我们把扫码枪装进手机里：手机当扫码枪小程序开发避坑实录分享
做了八年企业数字化，我带团队交付过连锁零售、医药流通、仓储物流大大小小几十个项目。这两年有个明显的变化：客户越来越不想再买专用扫码枪了。不是枪不好用，是贵、易丢、系统对接麻烦。老板们开口就是——“能不能直接用店里伙计的手机扫？扫完直接进我们的系统？”
听起来简单，不就是调个相机扫码吗？真做起来，坑比想象中深得多。这篇就把我们最近一年在“手机当扫码枪”小程序上的实战避坑经验，原原本本讲出来，供同行和甲方参考。
第一坑：以为调用 wx.scanCode 就完事。
微信小程序自带的扫码 API 确实方便，但它在强光、反光条码、低密度印刷品上识别率直线下降。我们在一家便利店试点时，冰柜上的凝结水让条码一半看不清，原生接口十次能扫上三次都算运气。后来我们改用了基于 OpenCV 二次处理的自定义相机组件，配合本地增强算法，识别率拉到 98% 以上。代价是开发周期多了三周，包体积涨了 400KB——但值。
第二坑：连续扫不过去，业务就卡脖子。
真实场景里，店员要“扫完一个立马扫下一个”。原生扫码界面每次确认后都会退回，效率极低。我们做了“连续扫码模式”：扫完不弹窗，直接走静默回调，列表实时刷新。这里注意，别在回调里写重逻辑，否则手机会发烫降频，反而更慢。我们把解析结果先丢进本地队列，再异步上报，体验顺滑很多。
第三坑：权限和隐私合规。
手机相机会触及用户隐私，尤其安卓。我们踩过审核被拒的亏：没写清“仅用于条码识别，不采集人脸与环境”。现在所有项目都在隐私协议里单独列条款，并且首次进入强制告知。别嫌麻烦，今年监管收紧，这块马虎不得。
第四坑：弱网与离线。
仓库地下室信号差，扫了传不上，伙计以为没扫成功又扫一遍，库存直接乱掉。我们加了本地 SQLite 缓存和冲突校验，出了库再有网也能补传，并且用递增值防重。这个机制救过我们两个客户的大促。
第五坑：硬件差异。
千元机和旗舰机摄像头差距巨大。我们做了机型白名单，低端机自动降分辨率保速度。别盲目追求高清，业务要的是快和准。
把扫码枪装进手机，不是把枪扔了，而是用软件把枪的能力重建一遍。过程中最大的体会是：别迷信平台原生能力，也别低估一线环境的复杂。真要做，先去现场扫一百个真实条码再回来写代码。
如果各位正在规划类似项目，欢迎交流，少走点弯路比什么都强。
微信号：18581869297
